Fission Dashboard shows the verification status of your account. You can resend your verification email if it ended up in your spam.

Like all Fission apps -- including the ones made by Fission directly -- you need to give permission to the Dashboard app to access your account info.

Fission users can recover a lost account with a Recovery Kit. You can create a Recovery Kit in the Fission Dashboard to ensure you will always have access to your account.

Make a Recovery Kit

Sign in to the Fission Dashboard and select Recovery Kit.

To create a Recovery Kit, you need to grant the Fission Dashboard access to your private files. This step is necessary for the Dashboard to recover your private files.

Allow creating a recovery kit and grant permission in the Fission Auth Lobby.

After granting permission, you can create a Recovery Kit.

The recovery kit should be stored somewhere safe. Anyone with access to your Recovery Kit can access your private files. If you lose your Recovery Kit, you will not be able to recover your account.

Download your Recovery Kit and save it somewhere safe.

We recommend you store it on a device or storage medium that you will not easily lose.

Recover your Account

If you have lost access to your account, you can recover it with a Recovery Kit from the Fission Dashboard.

Select the Recover your account option below the sign in button.

You will need your Recovery Kit and access to the email you used to create the account.

Drag your recovery kit onto the upload box or click the box to select it from your file system. Fission Dashboard will import your recovery kit.

After Fission Dashboard imports your Recovery Kit, select send email.

Fission will send you verification email. Click on the link in the email and the recovery page will give you an option to recover your account.

Select recover account and re-link your account by signing into the Fission Auth Lobby.

Make sure to keep the recovery page open while you re-link your account.

The Fission Auth Lobby and account recovery page will show you confirmation codes.

When you are satisfied that the codes match, confirm in the account recovery page.

After confirming, Fission will recover your account, and you can access your files again.

Your Recovery Kit will work again if you need to recover your account in the future.

Fission Drive is currently a preview release of our upcoming file storage and identity system that lets you take your files anywhere, encrypted end-to-end as well as for public hosting of files, websites, and apps.

The Preview release is an exploration of the interface, and currently supports only public files.

Enter any IPFS Hash

You can browse any IPFS directory, not just those hosted on Fission, by entering in the hash, or Content ID (CID), of a directory.

Features

Dark & Light Mode

Preview supports system wide / browser settings for dark vs. light mode and will switch automatically when you change those settings.

File Previews

Clicking on an image will give you a file preview.

Click on the double arrows in the top right hand corner to embiggen the preview to full screen. Hit the X to close the preview.

The "Open in new tab" link will give you a permanent link for sharing the current file, using the Fission IPFS gateway.

Mobile Support

Yes, this works on mobile!

Keyboard Shortcuts

Use arrow keys to navigate, enter to open preview.

Installing the Fission CLI

The Fission command line interface (CLI) is the most common way for developers to interact with Fission services.

macOS with Homebrew

Use the Homebrew recipe to install the CLI on macOS. This taps and installs in one command:

If you have any issues, check that libcrypto1.1 installed and linked on your system.

You can also follow the next section for a manual install on macOS.

Linux and Manual Installation

Head over to our page on Github and download the latest release for your operating system.

Grant execute permissions and move the binary onto to your PATH. For example, on Ubuntu 20.04:

Check that the CLI was installed correctly.

If you have any issues, check that you have libssl1.1 (installed with OpenSSL) and libtinfo5 (or libtinfo6). Most recent Linux distributions will already have these libraries installed.

Clock Configuration

Check that your clock is accurate. Account linking depends on an accurate clock and may fail due to clock drift.

Mismatched clocks between a host system and container or VM may also cause issues.

Upgrading the CLI

Run fission --version to check if you are using an old version of the CLI.

To upgrade the CLI on macOS, brew uninstall and brew untap to reset brew.

Reinstall with brew tap and brew install.

Setup

With fission installed, we are ready to set it up on your local machine. If this is your first time using fission, you will be prompted for a username and an email to confirm your new account.

A private key has been generated for your machine and saved in the ~/.config/fission/key/ directory. This key secures your communication with Fission services and works like using an SSH key to connect to GitHub.

Account Linking

Create a simple webpage

Let's publish a simple webpage with Fission! We will write a simple webpage, register it as a Fission app, and publish it to the web.

Create a project directory and an index.html file.

Add some content to index.html:

Run fission app register command to initialize the webpage as a Fission app. You will be prompted for a build directory.

Press enter to set hello-universe as your build directory, and fission will initialize your app.

Fission will create a fission.yaml file with your app configuration.

Run fission app publish to publish the webpage.

Copy the URL from the last line and paste it into your web browser to view the webpage live on the web. Nice and simple!

Fission will occasionally change how your file system is stored to enable new features, improve performance, and improve security. Some of these changes require a file system migration.

Because Fission has no control over your file system, we cannot migrate your file system for you. To help you with migrations, we've developed a command-line tool that upgrades your file system to the latest version.

When to migrate your file system

If your file system is outdated, you will see a message like this in the Auth Lobby ():

After removing a device, you will be able to create a new account. New accounts are always created at the latest file system version.

Running a migration

At the moment, running a migration requires familiarity working with the command line on your machine.

The Webnative File System (WNFS) migration tool will use your linked credentials when migrating your file system.

Step 4: Install wnfs-migration

You can now install the migration CLI tool with npm:

npm install --global wnfs-migration

Step 5: Run wnfs-migration

At this point, wnfs-migration has migrated a local copy of your WNFS. It will then ask you to confirm that you want to overwrite the synced version of your file system on the Fission servers.

Enter Y to confirm or n to decline and abort the migration process. If you confirm, wnfs-migration will sync your migrated file system: