Managing Your Account
The Fission CLI account management commands
Use fission setup, fission user whoami, and fission login to set up your account, display your username, and link your account in web browser.

Setup a new user

The fission setup command registers your account with Fission or links to your existing Fission account.
1
$ fission setup
2
🌱 Setting up environment
3
πŸͺ Downloading managed IPFS for Linux
4
πŸŽ›οΈ Configuring managed IPFS
5
generating ED25519 keypair...done
6
peer identity: 12D3KooWHZ3C1tDmzUhgi3A6LYmgBxvv1E1obtG7S2ZkYM1MN83
7
initializing IPFS node at /home/yourname/.config/fission/ipfs
8
πŸ”‘ Creating keys
9
🏠 Do you have an existing account? [Y/n] n
10
Username: YOURNAME
12
βœ… Registration successful! Head over to your email to confirm your account.
13
πŸŽ›οΈ Initializing user config file
14
βœ… Done! Welcome to Fission, YOURNAME ✨.
Copied!
When you register a new account, you will be prompted for a username and an email. Fission will send you an email to confirm your account and complete your registration.
The fission setup command will create a global config.yaml file in your ~/.config/fission directory. See the Global Fission YAML guide for more information about the config.yaml file.
The registration process will also create a Fission Drive for you automatically at the URL YOURNAME.fission.name using your Fission username.

Display user information

Use fission user whoami to display your username.
1
$ fission user whoami
2
πŸ’» Currently logged in as: fission
Copied!

Linking a web browser

You can link your Fission account in a web browser to interact with Fission-enabled apps. The fission login command sets up the CLI to listen for requests to link your account.
1
$ fission login
2
πŸ•šπŸŒ Listening for logins requests for griffin
Copied!
Open the Fission auth lobby in a browser window, select "Sign In", enter your Fission username, and select "Link Account".
The browser window and command line will display confirmation codes. Verify that the confirmation codes match and grant access at the command line.
1
$ fission login
2
πŸ•šπŸŒ Listening for logins requests for griffin
3
πŸ”’ Does this code match your second device? [4, 4, 5, 3, 0, 7] [Y/n] Y
4
🧞 Grant access? SuperUser all resources, from Tue, 11 May 2021 15:30:01 UTC until
5
Fri, 10 Mar 2276 15:30:31 UTC [Y/n] Y
6
🀝 Login to other device successful πŸŽ‰
Copied!
The browser window will update to show that you have successfully linked your account.

Linking from a web account

If you are signed into a Fission account in a web browser, you can link your account and use it at the command line.
Open the Fission auth lobby in a browser window.
Use fission setup to create and link a CLI user at your command line.
1
$ fission setup
2
🌱 Setting up environment
3
πŸͺ Downloading managed IPFS for Linux
4
πŸŽ›οΈ Configuring managed IPFS
5
generating ED25519 keypair...done
6
peer identity: 12D3KooWHZ3C1tDmzUhgi3A6LYmgBxvv1E1obtG7S2ZkYM1MN83
7
initializing IPFS node at /home/thuselem/.config/fission/ipfs
8
πŸ”‘ Creating keys
9
🏠 Do you have an existing account? [Y/n] Y
10
πŸ”— Please open auth.fission.codes on a signed-in device
11
πŸ“› Please enter your username: yeti
Copied!
When prompted, enter Y to confirm you have an account and enter your username from the browser window. The auth lobby and CLI will display a confirmation code.
When you have confirmed that the codes match, approve in the browser, and the CLI will complete the setup process and link your account.
1
$ fission setup
2
🌱 Setting up environment
3
πŸͺ Downloading managed IPFS for Linux
4
πŸŽ›οΈ Configuring managed IPFS
5
generating ED25519 keypair...done
6
peer identity: 12D3KooWHZ3C1tDmzUhgi3A6LYmgBxvv1E1obtG7S2ZkYM1MN83
7
initializing IPFS node at /home/thuselem/.config/fission/ipfs
8
πŸ”‘ Creating keys
9
🏠 Do you have an existing account? [Y/n] Y
10
πŸ”— Please open auth.fission.codes on a signed-in device
11
πŸ“› Please enter your username: yeti
12
πŸ”’ Confirmation code: [6, 0, 9, 1, 2, 3]
13
πŸŽ›οΈ Initializing user config file
Copied!

Setup with an existing key

You can set up your machine with an existing account if you have the machine_id.ed25519 key. Use --with-key argument and the path to your key.
1
$ fission setup --with-key ~/path/to/machine_id.ed25519
2
🌱 Setting up environment
3
πŸͺ Downloading managed IPFS for Linux
4
πŸŽ›οΈ Configuring managed IPFS
5
πŸ”‘ Setting up keys
6
πŸ•™πŸŽ›οΈ Initializing user config file
7
βœ… Done! Welcome to Fission, griffin ✨
Copied!
Last modified 3mo ago