Skip to main content

Spheron network

What is Spheron?​

Spheron is a platform-as-a-service (PaaS) designed for dapps looking to launch their applications on decentralized infrastructure with optimal performance, and provides compute capabilities, decentralized storage, CDN and web hosting out of the box. With its comprehensive set of tools and services rooted in web3 infrastructure provision, Spheron empowers developers to meet the dynamic demands of the digital landscape. Its exceptional performance not only rivals web2 counterparts but also showcases the potential of web3 technology for the next generation of applications.

Learn more about Spheron through our documentation.

How to deploy a static site on Spheron​

Deploying static apps on Spheron is straightforward. Follow these steps:

  1. Connect your Git provider:
    Connecting your Git provider allows Spheron to sync your repositories and trigger deployments whenever new updates are made. Spheron supports the following Git providers: Github, Gitlab, and Bitbucket.

  2. Set up your project:
    Create a new project on Spheron and choose your desired app repository for deployment.

  3. Select deployment protocol:
    Select the desired protocol for hosting your static app. Spheron supports Arweave, Filecoin, and IPFS.

  4. Configure deployment settings:
    Spheron will automatically detect and configure most of these settings for you, though you have to add environment variables in the dedicated section. If needed, modify the remaining parameters according to your requirements. That includes selecting the framework, branch, root directory, build and output settings, and the node engine.

  5. Trigger deployment:
    After configuring all the required settings, initiate the deployment process. Spheron will fetch your code, build the static files, and deploy them to your specified protocol.

  6. Access your app:
    Once the deployment is complete, you can access your app through the domain generated by Spheron. You also have the option to set up a custom domain for your app.

Checkout our Framework Guide for more info.

How to deploy dynamic apps/servers on Spheron​

Whether you're using a Docker image from Docker Hub or deploying a marketplace app, deploying compute instances on Spheron is simple and effortless. Follow these steps to deploy your compute instance on Spheron:

  1. Set up your cluster:
    Create a new cluster on Spheron by selecting Import from Docker Hub or Start from Marketplace App.

  2. For Docker Hub:

    1. Click "New Cluster" in the top-right corner.
    2. Select Import from Docker Hub.
    3. Enter the names for your cluster and docker image.
    4. Then, add the tag and click "Next."
    5. Choose your compute type option under Compute Type.
    6. Select your preferred Region, if any. If you do not add a region, the container will be deployed in any region for Spot, or in the eu-east region for On Demand. Click here to learn more.
    7. Spheron will automatically select the recommended plan for the specific template. If you intend to move forward with the recommended plan, click "Deploy" to initiate deployment.
    8. Select the instance plan that suits your needs. Use the "Create Custom Plan" toggle to create custom plans for your instance.
    9. Configure the storage (SSD) plan for your instance. Use the "Add Persistent Storage" toggle to add persistent storage for your instance.
    10. Create new Port Policy Mapping. Add the container port and select the exposed port you want to map it to. Refer to our docs for more information.
    11. Add Environment Variable, if any.
    12. Add Secret Environment Variable if the value is a secret key. It will not be saved in the database. Click here to learn more.
    13. You can add advanced configuration if required. Click here to read more.
    14. You can add a health checkup if required. Click here to learn more.
    15. Click "Deploy" to initiate deployment.

    Checkout our Server Guide for more info.

  3. For a Marketplace app:

    1. Click "New Cluster" in the top right corner.
    2. Select Start from Marketplace App.
    3. Pick your desired template from the marketplace.
    4. Choose your desired compute type option under Compute Type.
    5. Select your preferred Region, if any. If you do not add a region, the container will be deployed in any region for Spot, or in the eu-east region for On Demand. Click here to learn more.
    6. Spheron will automatically select the recommended plan for the specific template. If you intend to move forward with the recommended plan, just click "Deploy" to initiate deployment.
    7. Select the instance plan that suits your needs. Use the "Create Custom Plan" toggle to create custom plans for your instance.
    8. Configure the storage (SSD) plan for your instance. Use the "Add Persistent Storage" toggle to add persistent storage for your instance.
    9. You can add advanced configuration if required. Click here to know more.
    10. Click "Deploy" to initiate deployment.

    Checkout our Marketplace Guide for more info.

How to upload to IPFS using Spheron SDK​

1. Spheron Storage SDK (for Nodejs environments)​

Installation​

npm i @spheron/storage

Usage​

import { SpheronClient, ProtocolEnum } from "@spheron/storage";

const client = new SpheronClient({ token });

let currentlyUploaded = 0;

const { uploadId, bucketId, protocolLink, dynamicLinks } = await client.upload(
  filePath,
  {
    protocol: ProtocolEnum.IPFS,
    name,
    onUploadInitiated: (uploadId) => {
      console.log(`Upload with id ${uploadId} started...`);
    },
    onChunkUploaded: (uploadedSize, totalSize) => {
      currentlyUploaded += uploadedSize;
      console.log(`Uploaded ${currentlyUploaded} of ${totalSize} Bytes.`);
    },
  },
);

Checkout our Storage SDK Documentation for more info.

2. Spheron Browser Upload SDK (for Browser environments)​

Installation​

npm i @spheron/browser-upload

Usage​

Server

You have to set up a web server with an endpoint that will be used by the frontend to fetch the token for upload.

import { SpheronClient, ProtocolEnum } from "@spheron/storage";

...

app.get("/initiate-upload", async (req, res, next) => {
  try {
    const bucketName = "example-browser-upload"; // use your preferred name
    const protocol = ProtocolEnum.IPFS; // use your preferred protocol
    const token = process.env.SPHERON_TOKEN; // add your access token in .env or paste it here

    const client = new SpheronClient({ token });

    const { uploadToken } = await client.createSingleUploadToken({
      name: bucketName,
      protocol,
    });

    res.status(200).json({
      uploadToken,
    });
  } catch (error) {
    console.error(error);
    next(error);
  }
});

Client

You have to send a request to your server to create the uploadToken that will be used to upload files from the browser.

import { upload } from "@spheron/browser-upload";

...

const response = await fetch(`<BACKEND_URL>/initiate-upload`); // get the temporary access token from server
const resJson = await response.json();
const token =  resJson.uploadToken;

let currentlyUploaded = 0;

const { uploadId, bucketId, protocolLink, dynamicLinks } = await upload(files, {
  token,
  onChunkUploaded: (uploadedSize, totalSize) => {
    currentlyUploaded += uploadedSize;
    console.log(`Uploaded ${currentlyUploaded} of ${totalSize} Bytes.`);
  },
});

...

Checkout our Browser Upload SDK for more info.

Checkout all other SDKs for more in-depth information.

How to create and deploy apps using Spheron CLI​

Installation​

For Mac and Linux​

To install the Spheron CLI, run the following command in your terminal:

sudo npm install -g @spheron/cli

For Windows​

To install the Spheron CLI, open your terminal in administrator mode and run the following command:

npm install -g @spheron/cli

Usage​

spheron init​

The spheron init command allows you to initialize a new Spheron project. A spheron.json file is created in your current path that describes your project. It will be utilized by the spheron publish command.

Usage​

spheron init

Upon running this command, a prompter will appear that will allow you to select protocol, add project name, add path, and select framework. Here is how it will look:

? Project name: (Code)
? Upload protocol: (Use arrow keys)
  Arweave
  Filecoin
❯ IPFS

spheron publish​

The spheron publish command allows you to upload your project using the configuration that is described in the spheron.json file of your project.

Usage​

spheron publish
note

Make sure that you create a production build before running the spheron publish command.

Here is an example of how the result will look:

Spheron CLI 1.0.7

Publishing your dapp to IPFS 🚀
Uploading directory build
Upload started, ID of deployment: 643fce207c3c7a0012df33a7
⠙ Uploading to IPFS
✓ Success! Upload finished !
Here are upload details:
Upload ID: 643fce207c3c7a0012df33a7
Bucket ID: 643fce207c3c7a0012df33a5
Protocol Link: https://bafybeicrjwhn6nifl7tcuhkcitquvpumj426qa7r7ppcya5skmqly5n2la.ipfs.sphn.link
Dynamic Links: https://testapp-edab50.spheron.app

Checkout our CLI Documentation for more info.

How to view and retrieve content from IPFS using Spheron​

Dedicated IPFS gateways​

Dedicated gateways are IPFS gateways specifically designed to enhance access to pinned content across the network by offering faster speeds and increased rate limits.

Using dedicated gateways offers several benefits:

  • Improved speed
  • Increased rate limits
  • White-labeling gateway
  • Serve content from any IPFS node

Create a dedicated gateway​

Follow these steps to create a dedicated gateway:

  1. Log in to Spheron and navigate to the Gateways section in the navbar.
  2. Click Generate to create a new gateway.
  3. Enter a name for your gateway and click Create.

How to use your gateway​

To access content through your dedicated gateway, simply follow these steps:

  1. Obtain the CID (content identifier) of the file you wish to view.
  2. Append the CID to your gateway URL in the following format:
https://{gateway-name}.spheron.link/ipfs/{cid}

Checkout our gateway documentation for more information.

Further resources​

  • Visit our platform to learn more.
  • Access our comprehensive documentation for detailed information.
  • Follow us on Twitter for the latest updates and news.
  • Join our Community for dedicated support and assistance.