Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); podman documentation by m3ow-dev · Pull Request #179 · pelican/docs · GitHub
Skip to content

podman documentation - #179

Draft
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main
Draft

podman documentation#179
m3ow-dev wants to merge 3 commits into
pelican:mainfrom
m3ow-dev:main

Conversation

@m3ow-dev

@m3ow-devm3ow-dev commented Dec 16, 2025

Copy link
Copy Markdown

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive guide for deploying the Panel with Rootless Podman using Quadlets, covering prerequisites, configuration, systemd integration, SELinux handling, startup, maintenance, verification, logs, and data management.
    • Added Podman-specific configuration guidance for Wings, including tmp directory changes, permissions/SELinux remediation, service unit examples, and an OOM-killer note.
    • Added new Advanced docs navigation entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify

netlifyBot commented Dec 16, 2025

Copy link
Copy Markdown

Deploy Preview for pelica ready!

NameLink
🔨 Latest commitb5ab719
🔍 Latest deploy loghttps://app.netlify.com/projects/pelica/deploys/6941bc2fc819ce0008a0a4fe
😎 Deploy Previewhttps://deploy-preview-179--pelica.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitaiBot commented Dec 16, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Adds new Podman deployment documentation and updates Wings Podman guidance, plus a sidebar entry linking the new Podman doc; changes are documentation-only and do not modify runtime code or public APIs.

Changes

Cohort / File(s)Summary
Podman Deployment Documentation
docs/panel/advanced/podman.mdx
New full guide for deploying the Pelican Panel with Rootless Podman and Quadlets: prerequisites, directory/config layouts (Caddyfile, Pod YAML), systemd Quadlet usage, SELinux notes, startup/maintenance, verification, logs, and Podman volumes
Wings Podman Configuration Guide
docs/wings/optional-config.mdx
Appended Podman-specific instructions: enabling Podman, changing tmp directory, SELinux/permission remediation, sample Wings systemd unit, restart steps, and OOM killer note for game servers
Documentation Navigation
sidebars.ts
Added panel/advanced/podman entry to the Advanced category in the documentation sidebar

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across a few files; verify content accuracy and formatting.
  • Pay attention to:
    • docs/panel/advanced/podman.mdx for correctness of commands, YAML blocks, and SELinux instructions.
    • docs/wings/optional-config.mdx for the tmp_directory and log_config examples and the custom systemd unit sample.
    • sidebars.ts entry placement and import/path consistency.

Poem

🐰 I dug a doc, neat and sound,
Quadlets planted in Podman ground,
SELinux politely bowed,
Systemd hums soft and proud,
Pelican panel hops around 🥕✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check nameStatusExplanationResolution
Title check❓ InconclusiveThe title 'podman documentation' is vague and generic, lacking specificity about what aspect of Podman documentation is being added or modified.Consider a more descriptive title such as 'Add Podman deployment guide for Pelican Panel' or 'Document rootless Podman setup with Quadlets' to clearly convey the main change.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2bd8c03 and b5ab719.

📒 Files selected for processing (1)
  • docs/panel/advanced/podman.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/panel/advanced/podman.mdx

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/wings/optional-config.mdx (2)

183-183: Add space after # in shell comment.

Shell comments should have a space after the # for better readability, following standard shell scripting conventions.

Apply this diff:

-#Chown to the pelican's uid+# Chown to the pelican's uid

209-210: Provide more context for the OOM killer requirement.

The statement that "OOM killer must always be enabled... or else the wings will crash" is critical but lacks explanation. Consider adding:

  • Why this is a Podman-specific requirement
  • Where in the game server settings this is configured
  • What causes Wings to crash without it

Consider expanding this to:

### Important for Podman: OOM Killer Configuration
The OOM (Out-of-Memory) killer must always be enabled in the game servers' settings when using Podman. Without it, Wings will crash on server start due to [brief technical reason].
To configure this:
1.[Step-by-step instructions or link to relevant panel settings]
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 274ddb6 and 2bd8c03.

📒 Files selected for processing (3)
  • docs/panel/advanced/podman.mdx (1 hunks)
  • docs/wings/optional-config.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🔇 Additional comments (1)
sidebars.ts (1)

34-34: LGTM!

The sidebar entry is correctly added to the Advanced category and follows the existing structure.

Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/panel/advanced/podman.mdx Outdated
Comment threaddocs/wings/optional-config.mdx
m3ow-devand others added 2 commits December 16, 2025 15:08
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@notAreYouScared

Copy link
Copy Markdown
Member

Please address the conflicts

@m3ow-dev

Copy link
Copy Markdown
Author

I dont think the pelican panel project is going to incorporate podman natively soon, meaning i will close this issue until the project is out of beta.

@parkervcp

Copy link
Copy Markdown
Member

@m3ow-dev I am not against podman support. Keeping this around as a draft that you can update while the panel goes through changes may be a better idea.

@m3ow-devm3ow-dev reopened this Dec 30, 2025
@m3ow-dev
m3ow-dev marked this pull request as draft December 30, 2025 04:01
@m3ow-dev

Copy link
Copy Markdown
Author

All good, will continue to develop on this podman integration documentation

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@m3ow-dev@notAreYouScared@parkervcp