StaticDeploy

StaticDeploy

  • Docs
  • GitHub
  • Privacy

›Getting started

Getting started

  • Quickstart
  • Overview
  • Apps configuration
  • CI/CD Workflow

Guides

  • Deploying StaticDeploy with docker
  • Deploying static apps
  • Using a client-side router
  • Serving assets with custom headers
  • Using a fallback asset
  • Configuring JWT identity providers
  • Configuring OpenID Connect identity providers

Use with

  • Create React App
  • Vue CLI

Reference

  • Entities
  • Authentication and authorization
  • Using StaticDeploy's CLI
  • How StaticDeploy routes requests
  • Architecture

Quickstart

For this quickstart you'll need:

  • a recent version of docker
  • a recent version of nodejs

Set up StaticDeploy with docker

  • start StaticDeploy:

    docker run --rm --init \
      -e MANAGEMENT_HOSTNAME=local.staticdeploy.io \
      -e ENFORCE_AUTH=false \
      -p 80:80 \
      staticdeploy/staticdeploy
    
  • visit the Management Console at local.staticdeploy.io (which points to 127.0.0.1)

Publish a static app

  • install the StaticDeploy CLI:

    npm install --global @staticdeploy/cli
    
  • configure the CLI using environment variables:

    export STATICDEPLOY_API_URL=http://local.staticdeploy.io/api
    
  • clone the StaticDeploy repository and cd into it:

    git clone https://github.com/staticdeploy/staticdeploy.git
    cd staticdeploy
    
  • create a bundle for the demo static app in website/demo-static-app:

    staticdeploy bundle \
      --from website/demo-static-app \
      --name demo-static-app \
      --tag master \
      --description "version 1.0.0"
    
  • deploy the bundle to demo-static-app.staticdeploy.io:

    staticdeploy deploy \
      --app demo-static-app \
      --entrypoint demo-static-app.staticdeploy.io/ \
      --bundle demo-static-app:master
    
  • visit demo-static-app.staticdeploy.io (which also points to 127.0.0.1)

  • check out the deployment on the Management Console at local.staticdeploy.io. Try modifying the entrypoint configuration and see how demo-static-app.staticdeploy.io changes

Overview →
  • Set up StaticDeploy with docker
  • Publish a static app