{"id":13580339,"url":"https://github.com/tobiasmcnulty/dokku-aws","last_synced_at":"2025-08-23T17:39:37.980Z","repository":{"id":136774610,"uuid":"103854626","full_name":"tobiasmcnulty/dokku-aws","owner":"tobiasmcnulty","description":"One-click Dokku instance on AWS.","archived":false,"fork":false,"pushed_at":"2017-09-29T17:11:22.000Z","size":14,"stargazers_count":51,"open_issues_count":1,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-05T19:42:45.536Z","etag":null,"topics":["aws","cloudformation-template","dokku"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tobiasmcnulty.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-17T19:09:27.000Z","updated_at":"2023-12-08T14:03:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"63258215-32f0-4eb7-8363-4894bd2e0ffd","html_url":"https://github.com/tobiasmcnulty/dokku-aws","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobiasmcnulty%2Fdokku-aws","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobiasmcnulty%2Fdokku-aws/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobiasmcnulty%2Fdokku-aws/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobiasmcnulty%2Fdokku-aws/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tobiasmcnulty","download_url":"https://codeload.github.com/tobiasmcnulty/dokku-aws/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223888466,"owners_count":17220083,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cloudformation-template","dokku"],"created_at":"2024-08-01T15:01:49.987Z","updated_at":"2024-11-09T22:05:34.903Z","avatar_url":"https://github.com/tobiasmcnulty.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Dokku AWS\n=========\n\nThis is a simple CloudFormation stack for deploying a `Dokku \u003chttp://dokku.viewdocs.io/dokku/\u003e`_\ninstance to EC2 using an Ubuntu 16.04 LTS AMI. The instance is configured with an Elastic IP, so the\nIP will stay the same in case of stack updates that require the instance to be replaced.\n\nIf you wish to use your Dokku instance with S3, RDS, ElastiCache, and/or Elasticsearch, you should\nuse `aws-web-stacks \u003chttps://github.com/caktus/aws-web-stacks\u003e`_ instead.\n\nThe CloudFormation templates are written in `troposphere \u003chttps://github.com/cloudtools/troposphere\u003e`_,\nwhich allows for some validation at build time and simplifies the management of several related\ntemplates.\n\nYou can launch a new instance by clicking the Launch Stack button below or by pointing CloudFormation\nto the `underlying template`_ manually. Before launching a stack, make sure to upload your SSH public key\nto the `Key Pairs \u003chttps://console.aws.amazon.com/ec2/v2/home#KeyPairs:sort=keyName\u003e`_ section of the\nAWS console (this will be used both to allow logins to the ``ubuntu`` user on your EC2 instance and\nto allow deploys via the ``dokku`` user).\n\n|dokku-stack|_\n\n.. |dokku-stack| image:: https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png\n.. _dokku-stack: https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=my-dokku-stack\u0026templateURL=https://s3.amazonaws.com/dokku-aws/dokku_stack.json\n.. _underlying template: https://s3.amazonaws.com/dokku-aws/dokku_stack.json\n\nUsing the default values in this template (a ``t2.micro`` instance and 30 GB of disk space), your new\nDokku instance should fit within the `free tier \u003chttps://aws.amazon.com/free/\u003e`_ on AWS.\n\nDNS\n---\n\nAfter the stack is created, you'll want to inspect the Outputs for the PublicIP of the instance and\ncreate a DNS ``A`` record (possibly including a wildcard record, if you're using vhost-based apps)\nfor your chosen domain.\n\nFor help creating a DNS record, please refer to the `Dokku DNS documentation\n\u003chttp://dokku.viewdocs.io/dokku/configuration/dns/\u003e`_.\n\nDeployment\n----------\n\nDokku may take 5-10 minutes to install, even after the stack has finished creating. Once that's complete,\ncreate a new app on the remote server::\n\n    ssh dokku@\u003cyour domain or IP\u003e apps:create python-sample\n\nand deploy Heroku's Python sample to that app::\n\n    git clone https://github.com/heroku/python-sample.git\n    cd python-sample\n    git remote add dokku dokku@\u003cyour domain or IP\u003e:python-sample\n    git push dokku master\n\nYou should be able to watch the build complete in the output from the ``git push`` command. If the\ndeploy completes successfully, you should be able to see \"Hello world!\" at\nhttp://python-sample.your.domain/\n\nFor additional help deploying to your new instance, please refer to the `Dokku documentation\n\u003chttp://dokku.viewdocs.io/dokku/deployment/application-deployment/\u003e`_.\n\nLet's Encrypt\n-------------\n\nWe might as well get a free SSL certificate from Let's Encrypt, while we're at it::\n\n    ssh ubuntu@\u003cyour domain or IP\u003e sudo dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git\n    ssh dokku@\u003cyour domain or IP\u003e config:set --no-restart python-sample DOKKU_LETSENCRYPT_EMAIL=your@email.tld\n    ssh dokku@\u003cyour domain or IP\u003e letsencrypt python-sample\n\nThe Python sample app should now be accessible over HTTPS at https://python-sample.your.domain/\n\nGood luck and have fun!\n\nCopyright 2017 Tobias McNulty.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobiasmcnulty%2Fdokku-aws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftobiasmcnulty%2Fdokku-aws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobiasmcnulty%2Fdokku-aws/lists"}