{"id":17319876,"url":"https://github.com/dickermoshe/zappadock","last_synced_at":"2025-07-11T01:42:17.426Z","repository":{"id":43272536,"uuid":"461408623","full_name":"dickermoshe/zappadock","owner":"dickermoshe","description":"A CLI tool for running Zappa in AWS Lambda-like Docker containers.","archived":false,"fork":false,"pushed_at":"2022-09-08T19:49:24.000Z","size":59,"stargazers_count":18,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-13T08:13:26.460Z","etag":null,"topics":["aws","aws-lambda","django","docker","flask","python","python3","zappa","zappa-django","zappa-flask"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dickermoshe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-20T06:52:31.000Z","updated_at":"2024-04-04T00:14:29.000Z","dependencies_parsed_at":"2022-07-13T17:31:00.168Z","dependency_job_id":null,"html_url":"https://github.com/dickermoshe/zappadock","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/dickermoshe/zappadock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dickermoshe%2Fzappadock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dickermoshe%2Fzappadock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dickermoshe%2Fzappadock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dickermoshe%2Fzappadock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dickermoshe","download_url":"https://codeload.github.com/dickermoshe/zappadock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dickermoshe%2Fzappadock/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260477333,"owners_count":23015050,"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","aws-lambda","django","docker","flask","python","python3","zappa","zappa-django","zappa-flask"],"created_at":"2024-10-15T13:27:50.871Z","updated_at":"2025-07-11T01:42:17.337Z","avatar_url":"https://github.com/dickermoshe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZappaDock\n[![Downloads](https://pepy.tech/badge/zappadock)](https://pepy.tech/project/zappadock)\n\n### Install \nIt's dead simple :\n```\n$ pip install zappadock\n```\n\n\n## Usage \n1. Check that the Docker daemon is running by typing `docker info` command from a terminal.\n2. Set your AWS credentials in environmental variables or in the `~/.aws` folder.  See the [Amazon Docs](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html#environment-variables) for more information.\n3. Run `zappadock` in the directory you wish to run your Zappa commands.  \nYour directory will be loaded in a docker container, and a virtual environment will be created and activated.  \n\n4. To run the built-in servers:\n* Django:  \n`python manage.py runserver 0.0.0.0:8000`  \n* Flask:  \n`flask run --host=0.0.0.0 --port=8000`  \n\nIf you have any problems, open a issue and we'll figure it out.\n  \n  \n  \n## About\nThis package makes dealing with [Zappa](https://github.com/zappa/Zappa) a walk in the park.\n#### How ?\nZappa runs Flask/Django web apps on AWS Lambda.  \nWe LOVE Zappa. However it's not the MOST user-friendly application ever.\n#### Why ?\nYou see, Zappa builds all your requirements before uploading your app to AWS Lambda. However, pip downloads the packages that are compatible with the computer it is running on, so when Zappa uploads it to AWS Lambda, many packages don't work (notably `psycopg2` among others).\n#### What's the solution ?\nThe solution recommend by the [The Django Guide for Zappa](https://romandc.com/zappa-django-guide/) is to run your Zappa commands in a docker container similar to the one that AWS Lambda uses.  \nThis will ensure that all the dependencies will be AWS Lambda compatible. \nThis ZappaDock streamlines the workflow.\n#### What Does ZappaDock Do ?\nZappaDock does 3 things.\n1. Run a docker container with your code mounted.\n2. Load your AWS Credentials from the `~/.aws` folder and environmental variables into the container.\n3. Create and activate a virtual environment inside the container.  \n\nSo now you can test and deploy your code confident that it will work once deployed.  \n\n\n## Contributing\nI mostly made this for myself.  If you want to help make this a masterpiece, be a sport and contribute.  \nThanks!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdickermoshe%2Fzappadock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdickermoshe%2Fzappadock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdickermoshe%2Fzappadock/lists"}