Exporting components to bit.dev requires that Bit client (Bit cli) on your machine is logged in to the account. Bit tries to log into the server according to the steps defined here.
A token or a key is associated with a single user, and the privileges, such as collections visibility and access, are determined according to that user's privileges.
Authenticate with Token
Use bit login to generate an authentication token for a [bit.dev]. Bit uses the token to configure the local Bit configuration.
To authenticate your Bit client, run the following command:
$ bit login Your browser has been opened to visit: https://bit.dev/bit-login?redirect_uri=http://localhost:8085...
bit.dev stores a token per machine. When re-logging on the same machine, the previous token expires and a new token is created. If you want to a permanent token (e.g. for CI), you can set a machine name in the login. The token will be associated with that machine name, and only expires when performing another login with the same machine name:
bit login --machine-name=ci_server
To see a list of all logged-in devices, go to profile settings.
You can remove tokens, forcing Bit clients to re-authenticate themselves with the account.
Authenticate with SSH
It is also possible to work with SSH key pair to authenticate with bit.dev.
Follow the steps described here for generating SSH keys.
If you know how to generate your SSH key, you can skip the next part and move to authenticate your SSH Key to bit.dev. Follow the steps below to generate SSH keys:
Generate SSH key
Open a terminal application.
Run this command (replace ‘email’ with the email associated with your Bit.dev account):
ssh-keygen -t rsa -b 4096 -C "[email protected]"
Accept the default location for the key file.
Start the SSH agent:
eval "$(ssh-agent -s)"
Add the private key we’ve created in the last step:
- Download and start the puttygen.exe generator.
- In the "Parameters" section choose SSH2 DSA and press Generate.
- Move your mouse on the small screen to generate the key pairs.
- Enter a key comment, which identifies the key (useful when you use several SSH keys).
- Click "Save private key" to save your private key.
- Click "Save public key" to save your public key.
Upload public SSH key to bit.dev
- Log in to your bit.dev account.
- Click on the user icon to open the user actions menu.
- Click on the ‘Settings’ link to reach the user settings section. Once inside, click on ‘SSH Keys’ in the left pane.
- In the ‘SSH Keys’ section, click on ‘new SSH key’.
- Type a name for the key. The key name documents the key, and will not affect the behavior of the system.
Key- Copy the content of the file that you generated and ends with
- Click on ‘Add SSH key’.
A new item is added to the SSH key list. This means that you are now connected via SSH and can export and import components from the bit.dev.
Configure local Bit client
To set your username and email in Bit, use the bit config command.
- If you've used
bit loginto authenticate, the username and email is set according to the Bit account.
- If no configuration values are defined for Bit, it falls back to read the values from
bit config set user.name "mickey mouse" bit config set user.email [email protected]
There are several things you can do if you encountered
fatal: permission to Collection <collectionname> was denied error message.
Timeout after a long hang time
Bit uses SSH to communicate with remote servers. A long hang time and authentication failure is usually the result of a firewall blocking the relevant port (22).
To see if that's the case, try and connect to the Bit remote server directly. If you are unable to connect, check the firewall configuration. If this test passes, email us at [email protected].
Make sure you have telnet installed, and run the following command. If you get the response bellow, you have access to your account with SSH.
$ telnet hub.bit.dev 22 Trying 188.8.131.52... Connected to hub.bit.dev. Escape character is '^]'. SSH-2.0-ssh2js0.4.6srv
Bit.dev account issues
Some issues may relate to simply account configuration issues.
You are not signed up to bit.dev
Wrong username/password combination
In case you are using
bit login, Bit will ask for your username/password combination for your bit.dev account. Make sure you have provided with the correct combination of it.
In case you have forgotten your password, head to your setting page to reset it.
No permission to the Collection
It may be that you do not have permissions to access the Collection in question.
- If the Collection is public, you can import component from it, but you have to have write permissions to export to it.
- If the Collection is private, you must have read/write permission in order to import/export components to it.
SSH keys issues
There are several configuration issues that may occur if you hit any permission issues when working with SSH keys and remote collections.
If the SSH connection is not established due to issues with SSH keys, Bit will fail to authenticate.
Bit and SSH Agent
In you are using SSH agent to store and manage your private SSH keys, Bit will communicate with it to use them when opening a remote connection.
Private SSH key not found
Check for the location of the private SSH key that is either configured to your SSH agent. If the configured path points to a wrong location, Bit will not be able to authenticate.
SSH Agent process is down
Check if the SSH agent process is running correctly, and you key is configured.
Run these command to start the process and add the correct private key.
eval "$(ssh-agent -s)" ssh-add -K ~/.ssh/id_rsa
SSH key has a passphrase
In case you use
bit config ssh_key_file to point Bit to the location of your private key, and that key has a passphrase, Bit will not be able to use it properly. In such cases, please refer to using an SSH agent instead.
No/Wrong public key uploaded to bit.dev
Check if you are using the right public SSH key for your profile.