Getting started with Bytesafe is easily done in minutes:
- Create your account & admin user
- Use the npm client to publish and install packages from Bytesafe
- Invite your team members
- Add additional Bytesafe registries and upstreams
Create your account & admin user
First step of the sign up is to choose an account name (this will be part of the domain
name used to access Bytesafe, e.g.
The next step is to create an admin user for your new account. You can sign up either with social logins (Google & GitHub currently supported) or via the email & password.
After account creation has been completed you will be signed in to your new account and directed to the Bytesafe console.
From the console you can manage your account, invite your team members, setup registries, push and pull packages and more.
Using the npm client with Bytesafe
Bytesafe’s private registries are fully compatible with the npm client. Use
npm as normal, no need to learn new commands or change your workflow.
New accounts includes an initial registry (named default) with the npmjs public registry pre-configured as an upstream.
Configure npm to use your new registry
The npm client stores its config in file ~/.npmrc. To add credentials for your new Bytesafe registry account, run
$ # Retrieve authentication token from the Bytesafe console (available on registry page)
$ # use --registry flag to point to your bytesafe registry
$ npm --registry 'https://example.bytesafe.dev/r/default' login
Email(this IS public): email@example.com
If you want npm to use a Bytesafe registry as the default registry, you can set it with the
npm config command:
$ npm config set registry 'https://example.bytesafe.dev/r/default'
Publishing packages to a registry
You can publish packages to your new registry using the
npm publish command.
$ # you can use the --registry flag to override the default registry
$ npm --registry https://example.bytesafe.dev/r/default publish 'some-package'
For more information on the
npm publish command and its uses, please see official npm documentation for npm publish
Installing packages from a registry
npm install command installs a package, and any packages that it depends on from a registry.
$ npm --registry https://example.bytesafe.dev/r/default install 'some-package'
If the specified Bytesafe registry does not contain the specific package, the package will be pulled from an upstream (if configured) and stored in the registry.
For more information on the
npm install command and its uses, please see official npm documentation for npm install
Inviting your team members
Inviting others to access your Bytesafe account and registries is easy.
Team Members section of the Bytesafe console let’s you invite others by email. Recipients will receive an invite link that lets them create a user with access to the same registries as the inviter.
Team members section is only available for account admin users. By default, the user that created the account is set as admin.
The team members page also keeps track of pending invites, has the option to resend invites as well as the option to disable user access to the account.
If the initial registry does not match your desired setup, you can configure your own registries and upstreams to fit your teams workflow.
To create a new registry, navigate to Registries and click the Create registry button. Enter a registry name and description and your new registry will be created.
You can rename, change the description or delete a registry, by navigating to the registry and selecting the Settings tab.
Upstreams are linked registries, that can be either a public registry (registry.npmjs.org), other Bytesafe registries or a URL to an npm compatible registry.
Package versions can be pulled from an upstream down into a registry (either manually or when running
Packages can also be published (“pushed”) from a Bytesafe registry up to an upstream.
A registry can have multiple upstreams configured with a priority order in which they are searched.
To add and / or configure upstreams, navigate to the registry and click the Upstreams tab.
We would love to hear from you!
Unanswered questions on how to use Bytesafe? Want to know more about how Bytesafe can help your organizations? Have suggestions for Bytesafe’s roadmap?
Contact us here and we will get back to you!