https://github.com/sandstorm-io/vagrant-spk

Packaging tool for Sandstorm, a self-hosting platform for web apps!
https://github.com/sandstorm-io/vagrant-spk

hacktoberfest sandstorm self-hosted self-hosting

Last synced: about 2 months ago
JSON representation

Packaging tool for Sandstorm, a self-hosting platform for web apps!

• Host: GitHub
• URL: https://github.com/sandstorm-io/vagrant-spk
• Owner: sandstorm-io
• License: apache-2.0
• Created: 2015-03-09T01:31:43.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2024-03-16T18:30:31.000Z (9 months ago)
• Last Synced: 2024-08-02T03:11:52.889Z (5 months ago)
• Topics: hacktoberfest, sandstorm, self-hosted, self-hosting
• Language: Python
• Homepage:
• Size: 957 KB
• Stars: 55
• Watchers: 10
• Forks: 29
• Open Issues: 64
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# vagrant-spk

`vagrant-spk` is a tool designed to help app developers package apps for [Sandstorm](https://sandstorm.io).

## Example usage:

    git clone git://github.com/sandstorm-io/vagrant-spk

    git clone git://github.com/sandstorm-io/php-app-to-package-for-sandstorm

    export PATH=$(pwd)/vagrant-spk:$PATH

    cd php-app-to-package-for-sandstorm

    vagrant-spk setupvm lemp

    vagrant-spk vm up

    vagrant-spk init

    # edit .sandstorm/sandstorm-pkgdef.capnp in your editor of choice

    vagrant-spk dev

    # visit http://local.sandstorm.io:6090 in a web browser

    # log in as Alice, the admin account

    # launch an instance of the example app, play around with it

    # then, press Ctrl-C to stop the tracing vagrant-spk dev

    vagrant-spk pack example.spk

    # You now have an .spk file.  Yay!

    # Verify it works by going to http://local.sandstorm.io:6090,

    # select "My Files" -> "Upload an app", select your .spk file,

    # upload it, install it, and create a new instance of your app.

## What the files are for

`vagrant-spk` will create a `.sandstorm/` folder in your repo and set up some

files with some defaults for your app stack.  You will likely need to modify

some of these to adapt their behavior to make the most sense for your app.

See the [vagrant-spk docs on customizing your

package](https://docs.sandstorm.io/en/latest/vagrant-spk/customizing/)

for full details.

## Example apps

See the [example app listing in the vagrant-spk

documentation.](https://docs.sandstorm.io/en/latest/vagrant-spk/customizing/#example-setups)