Packer scripts that were used to build this 1-Click App

Source Code

<h1 id="django-1-click">Django 1-Click</h1>
<p>Deploy Django on Ubuntu 24.04 with PostgreSQL, Gunicorn, and Nginx. By default, PostgreSQL runs locally. You can optionally attach a DigitalOcean Managed PostgreSQL database during deployment.</p>
<h2 id="getting-started">Getting Started</h2>
<ol>
<li>Select the Django 1-Click from the DigitalOcean Marketplace</li>
<li>Choose a Droplet size and region</li>
<li>Optionally select <strong>Add a Database</strong> to provision a Managed PostgreSQL database (see below)</li>
<li>Create the Droplet and SSH in as <code>root</code></li>
</ol>
<p>On first boot, a sample Django project is created and started automatically.</p>
<p><strong>Django admin:</strong></p>
<ul>
<li><strong>URL:</strong> <code>http://your-droplet-ip/admin</code></li>
<li><strong>Username:</strong> <code>django</code> (see <code>/root/.digitalocean_passwords</code>)</li>
<li><strong>Password:</strong> stored in <code>/root/.digitalocean_passwords</code></li>
</ul>
<h2 id="using-a-digitalocean-managed-database-optional">Using a DigitalOcean Managed Database (Optional)</h2>
<p>When creating your Django Droplet, you can select <strong>Add a Database</strong> to provision a DigitalOcean Managed PostgreSQL database at the same time. A managed database replaces the local PostgreSQL instance to better secure your data and gives you easy backups, connection pools, and metrics. No manual DBaaS setup is required.</p>
<h3 id="what-happens-when-you-add-a-database">What happens when you add a database</h3>
<p>When you choose this option during Droplet creation, DigitalOcean:</p>
<ol>
<li>Provisions a Managed PostgreSQL cluster in the same region as your Droplet</li>
<li>Passes connection credentials to your Droplet at first boot in <code>/root/.digitalocean_dbaas_credentials</code></li>
</ol>
<p>During first-boot setup, the Droplet automatically:</p>
<ol>
<li>Waits for the PostgreSQL cluster to become available (this may take a few minutes)</li>
<li>Creates a dedicated <code>django</code> database user and <code>django</code> database on the managed cluster</li>
<li>Updates <code>/home/django/django_project/django_project/settings.py</code> with the managed host and port</li>
<li>Runs Django migrations against the managed database</li>
<li>Stops and disables the local PostgreSQL instance</li>
</ol>
<p>Database credentials for the Django application are stored in <code>/root/.digitalocean_passwords</code> (<code>DJANGO_POSTGRESS_PASS</code>).</p>
<h3 id="security-trusted-sources">Security: Trusted Sources</h3>
<p>Your Droplet is not automatically added to the Managed Database&#39;s trusted sources. For better security, add your Droplet&#39;s public IP address to the database cluster&#39;s <strong>Trusted Sources</strong> in the <a href="https://cloud.digitalocean.com/databases" rel="noopener" target="_blank">DigitalOcean control panel</a>:</p>
<ol>
<li>Open your database cluster in the control panel</li>
<li>Go to <strong>Settings</strong> → <strong>Trusted Sources</strong></li>
<li>Add your Droplet&#39;s public IP address</li>
</ol>
<h3 id="modifying-database-settings-later">Modifying database settings later</h3>
<ul>
<li><strong>Django settings:</strong> Update database configuration in <code>/home/django/django_project/django_project/settings.py</code></li>
<li><strong>Application password:</strong> <code>/root/.digitalocean_passwords</code> (<code>DJANGO_POSTGRESS_PASS</code>)</li>
<li><strong>Password rotation:</strong> If you change the database password in the control panel, update <code>settings.py</code> and <code>/root/.digitalocean_passwords</code> to match</li>
</ul>
<h2 id="file-locations">File Locations</h2>
<ul>
<li><strong>Django project:</strong> <code>/home/django/django_project</code></li>
<li><strong>Passwords and keys:</strong> <code>/root/.digitalocean_passwords</code></li>
<li><strong>Setup log:</strong> <code>/var/log/one_click_setup.log</code></li>
</ul>
<h1 id="get-your-code-on-here">Get your code on here</h1>
<p>Clone your Django code onto the droplet, anywhere you like. Note: If you&#39;re not using a source control, you can directly upload the files to your droplet using SFTP.</p>
<p>You can try to reuse this project, located in <code>/home/django/django_project</code>, or start fresh in a new location and edit Gunicorn&#39;s configuration to point to it at <code>/etc/systemd/system/gunicorn.service</code>. You can also change how nginx is routing traffic by editing <code>/etc/nginx/sites-enabled/default</code></p>
<p>Cd into the directory where your Django code lives, and install any dependencies. (For example, if you have a <code>requirements.txt</code> file, run <code>pip install -r requirements.txt</code>.)</p>
<p>That&#39;s it! Whenever you make code changes, reload Gunicorn like so:</p>
<pre><code class="shell language-shell">PID=$(systemctl show --value -p MainPID gunicorn.service) &amp;&amp; kill -HUP $PID</code></pre>
<h1 id="play-in-the-admin-area">Play in the admin area</h1>
<p>The standard Django admin area is accessible at <code>/admin</code>. The login and password are stored in the <code>DJANGO_USER*</code> values you see when you call <code>cat /root/.digitalocean_passwords</code> while logged in over SSH.</p>
<h1 id="get-production-ready">Get production-ready</h1>
<p>There&#39;s a lot you&#39;ll want to do to make sure you&#39;re production-ready. Here are the popular things that people will do.</p>
<p><strong>Firewall:</strong> Review your firewall settings by calling sudo ufw status, and make any changes you need. By default, only SSH/SFTP (port 22), HTTP (port 80), and HTTPS (port 443) are open. You can also disable this firewall by calling sudo ufw disable and use a DigitalOcean cloud firewall instead, if you like (they&#39;re free).</p>
<p><strong>Domain:</strong> Register a custom domain</p>
<p><strong>Storage:</strong> You can mount a volume (up to 16TB) to this server to expand the filesystem, provision a database cluster (that runs MySQL, Redis, or PostgreSQL), or use a Space, which is an S3-compatible bucket for storing objects.</p>

Django

Nginx

Certbot

Gunicorn

Postgres

Postfix

DigitalOcean

Focus on building great things, while you use these 1-Click Apps to build your business.

These 1-Click Apps make it simple to deploy and manage your clients' infrastructure. Save time and resources, while reducing headaches and passing the value onto your clients.

Apps for agencies and website development shops

Work more effectively from home or remotely with these 1-Click Apps.

Work more effectively from home or remotely

Stop spending hours editing YAML and Helm charts. Instead, use these popular, preconfigured solutions to add apps to your Kubernetes cluster in minutes instead of days.

1-Click Apps for managing Kubernetes environments

Stay focused on teaching and learning, instead of managing infrastructure. 

1-Click Apps for students and educational institutions

Secure your network with a VPN, protect your database, and more, with this selection of 1-Click Apps.

SaaS Add-Ons make your DigitalOcean infrastructure better! Check out the full list of SaaS Add-Ons here!  

New Feature Alert: Introducing Software License Subscriptions on DigitalOcean Marketplace!

We now support Droplet 1-Click updates via API. See documentation for the details

Check out Tabnine, the AI coding assistant that accelerates & simplifies software development.

Description

Software Included

Getting started after deploying Django

API Creation