Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

docs(guide): describe storage growth and bump the footer to v1.2.8

ExTve3bd085324b2
diff --git a/docs/guide/backends.html b/docs/guide/backends.html
index dcab6a0..0937b2c 100644
--- a/docs/guide/backends.html
+++ b/docs/guide/backends.html
@@ -172,7 +172,7 @@
<a class="prev" href="performance.html"><span class="dir">Previous</span>&larr; Performance</a>
<a class="next" href="networking.html"><span class="dir">Next</span>Networking &amp; ports &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/getting-started.html b/docs/guide/getting-started.html
index 9dbcb5e..94ffac7 100644
--- a/docs/guide/getting-started.html
+++ b/docs/guide/getting-started.html
@@ -68,11 +68,11 @@
<p>The first time you open Podroid a three-step wizard runs before anything else.</p>
<h3>Step 1: Persistent storage size</h3>
- <p>Choose how large the writable VM disk image will be: 2, 4, 8, 16, 32, or 64 GB. This image lives in the app's private storage and holds everything you install inside the VM - packages, container images, config files. Pick more than you think you need.</p>
+ <p>Choose how large the writable VM disk image will be: from 2 GB up to 512 GB, limited to the free space on your phone. This image lives in the app's private storage and holds everything you install inside the VM - packages, container images, config files. Pick more than you think you need.</p>
- <div class="callout warn">
- <span class="label">Choose carefully</span>
- <p>The storage size is set once and cannot be changed later without a full reset that wipes all VM data. If you run out of space you will need to reset.</p>
+ <div class="callout note">
+ <span class="label">You can grow it later</span>
+ <p>You can increase the storage size later in Settings, but it can never be shrunk, so start with a size you are comfortable dedicating to the VM.</p>
</div>
<h3>Step 2: VM configuration</h3>
@@ -127,7 +127,7 @@
<a class="prev" href="index.html"><span class="dir">Previous</span>&larr; Overview</a>
<a class="next" href="how-it-works.html"><span class="dir">Next</span>How it works &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/how-it-works.html b/docs/guide/how-it-works.html
index b187d25..aa064c8 100644
--- a/docs/guide/how-it-works.html
+++ b/docs/guide/how-it-works.html
@@ -143,7 +143,7 @@
<a class="prev" href="getting-started.html"><span class="dir">Previous</span>&larr; Getting started</a>
<a class="next" href="performance.html"><span class="dir">Next</span>Performance &amp; why it's slow &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/index.html b/docs/guide/index.html
index c48541c..f0efd6c 100644
--- a/docs/guide/index.html
+++ b/docs/guide/index.html
@@ -81,7 +81,7 @@
<span></span>
<a class="next" href="getting-started.html"><span class="dir">Next</span>Getting started →</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/limitations.html b/docs/guide/limitations.html
index d5f3ede..eef53ec 100644
--- a/docs/guide/limitations.html
+++ b/docs/guide/limitations.html
@@ -99,8 +99,8 @@
</tr>
<tr>
<td>Storage</td>
- <td>Size cannot be changed after setup without a full reset</td>
- <td>The persistent ext4 overlay image (<code>storage.img</code>) is created at first-boot time and cannot be non-destructively resized later. Choose your storage size in the setup wizard. A future release may add live resize; for now a factory reset is required to change the allocation.</td>
+ <td>Size can grow but never shrink</td>
+ <td>The persistent ext4 overlay image (<code>storage.img</code>) can be enlarged from Settings; the guest resizes its filesystem on the next start. Shrinking is not supported, and choosing a size larger than the phone's free space is not offered.</td>
</tr>
<tr>
<td>Background stability</td>
@@ -196,7 +196,7 @@
<a class="prev" href="settings.html"><span class="dir">Previous</span>&larr; Terminal &amp; settings</a>
<a class="next" href="use-cases.html"><span class="dir">Next</span>Use cases &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/migrations.html b/docs/guide/migrations.html
index a23e9b0..eda774f 100644
--- a/docs/guide/migrations.html
+++ b/docs/guide/migrations.html
@@ -142,7 +142,7 @@ rc-update -u add my-service default</code></pre>
<a class="prev" href="packages.html"><span class="dir">Previous</span>&larr; Packages &amp; services</a>
<a class="next" href="desktop.html"><span class="dir">Next</span>Desktops &amp; X11 viewer &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/networking.html b/docs/guide/networking.html
index 9fddb71..6ede0cd 100644
--- a/docs/guide/networking.html
+++ b/docs/guide/networking.html
@@ -289,7 +289,7 @@ pasv_addr_resolve=NO
<a class="prev" href="backends.html"><span class="dir">Previous</span>&larr; Backends: QEMU &amp; AVF</a>
<a class="next" href="packages.html"><span class="dir">Next</span>Packages &amp; services &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/packages.html b/docs/guide/packages.html
index a360652..a8a8609 100644
--- a/docs/guide/packages.html
+++ b/docs/guide/packages.html
@@ -199,7 +199,7 @@
<a class="prev" href="networking.html"><span class="dir">Previous</span>&larr; Networking &amp; ports</a>
<a class="next" href="migrations.html"><span class="dir">Next</span>Updates &amp; migrations &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/performance.html b/docs/guide/performance.html
index 069be6a..bbcbcd8 100644
--- a/docs/guide/performance.html
+++ b/docs/guide/performance.html
@@ -147,7 +147,7 @@
<a class="prev" href="how-it-works.html"><span class="dir">Previous</span>&larr; How it works</a>
<a class="next" href="backends.html"><span class="dir">Next</span>Backends: QEMU &amp; AVF &rarr;</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/settings.html b/docs/guide/settings.html
index e351ca9..d232e5d 100644
--- a/docs/guide/settings.html
+++ b/docs/guide/settings.html
@@ -124,8 +124,8 @@
</tr>
<tr>
<td>Storage size</td>
- <td>Set at first-run setup</td>
- <td>The size of the persistent overlay image (<code>storage.img</code>). Set during setup; changing it requires a full VM reset.</td>
+ <td>2 GB to 512 GB, grow only</td>
+ <td>The size of the persistent overlay image (<code>storage.img</code>). Chosen during setup and can be increased here later; the list only offers sizes that fit the phone's free space, and it can never be shrunk. A larger size takes effect on the next VM start. Locked while the VM is running or Load balance is on.</td>
</tr>
<tr>
<td>Start VM on boot</td>
@@ -224,7 +224,7 @@
<a class="prev" href="desktop.html"><span class="dir">Previous</span>← Desktops &amp; X11 viewer</a>
<a class="next" href="limitations.html"><span class="dir">Next</span>Limitations &amp; troubleshooting →</a>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>
diff --git a/docs/guide/use-cases.html b/docs/guide/use-cases.html
index 9fc37dd..0b81df0 100644
--- a/docs/guide/use-cases.html
+++ b/docs/guide/use-cases.html
@@ -186,7 +186,7 @@
<a class="prev" href="limitations.html"><span class="dir">Previous</span>&larr; Limitations &amp; troubleshooting</a>
<span></span>
</div>
- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.7. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>
</main>
</div>