Need help with btcpayserver-doc?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

btcpayserver
253 Stars 112 Forks 2.6K Commits 27 Opened issues

Description

BTCPay Server Official Documentation

Services available

!
?

Need anything else?

Contributors list

BTCPay Server Documentation

Build Status

Introduction

BTCPay Server is an open-source, self-hosted payment processor for Bitcoin and other cryptocurrencies.

If you have trouble using BTCPay Server, consider joining the communities listed on the official website to get help from community members.

Only file a Github issue for technical issues you can't resolve through other channels or feature requests you've validated with other members of community.

Please check out our official website, our complete documentation and FAQ for more details.

Contributing

Pull requests are welcome and appreciated. To contribute to BTCPay Server, first check the contributing guidelines.

If you're beginner, take a look at the step by step guide on how to contribute to BTCPay Server documentation below.

Contributing to Documentation

Build the Documentation Locally

In order to build the website locally, you'll need Node.js >= 12.16 (or basically the latest LTS version). A prerequisite for the

setup-deps.sh
script is jq.

The setup is straight forward:

# Install dependencies
npm install

Link external doc repos

./setup-deps.sh

Serve locally (by default on port 8080)

npm start

Text Highlights

There are three types of text highlights that can be used to display different colored boxes.

A green box displaying a friendly tip:

:::tip
foo
:::

A yellow box with a cautious warning:

:::warning
foo
:::

A red box with a clear danger, you can also add a title

foo
to any container:
:::danger foo
bar
:::

SEO improvements

We are using the Vuepress SEO plugin to add relevant meta tags to the site and individual pages.

To improve the meta attributes of a specific page, you can add them as YAML frontmatter like this: (see the WooCommerce page for an example)

---
description: How to integrate BTCPay Server into your WooCommerce store.
tags:
- WooCommerce
- WordPress
- Plugin
- eCommerce
---
# WooCommerce integration

This document explains how to integrate BTCPay Server into your WooCommerce store.

Embedding YouTube videos

To add a YouTube video with a preview, you can so so by linking to it like this:

[![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/mqdefault.jpg)](https://www.youtube.com/watch?v=YOUTUBE_VIDEO_ID_HERE)

Note that the link item need to be a preview image (either from YouTube or a custom one) to result in an embedded video.

External documentation repos

The build documentation site combines a bunch of docs living in different repositories.

Before the build we check out the other repositories, copy their docs into the right places and link them just as the docs in this repo.

The process for that is defined in the setup-deps.sh script.

External repos can trigger the docs build whenever they change. You can use GitHub's repository_dispatch feature for this, which is exposed via the API:

curl -X POST https://api.github.com/repos/btcpayserver/btcpayserver-doc/dispatches \
  -u "${{ secrets.GH_PAT }}" \
  -H "Accept: application/vnd.github.everest-preview+json" \
  -H "Content-Type: application/json" \
  --data '{"event_type": "build_docs"}'

The

GH_PAT
needs to be a personal access token.

Check for broken links

The GitHub Actions pipeline checks for broken links after deploying the production site. You can also run the link check locally using

npm run linkcheck:local
. The dev server needs to be running alongside for this to work.

Supporters

The BTCPay Server Project is proudly supported by these entities through the BTCPay Server Foundation.

  <td align="center" valign="middle">
    <a href="https://lunanode.com" target="_blank">
      <img src="https://raw.githubusercontent.com/btcpayserver/btcpayserver/master/BTCPayServer/wwwroot/img/lunanode.svg?sanitize=true" alt="LunaNode" height="100">
      <br>
      <span>LunaNode</span>
    </a>
  </td>
  <td align="center" valign="middle">
    <a href="https://walletofsatoshi.com/" target="_blank">
      <img src="https://raw.githubusercontent.com/btcpayserver/btcpayserver/master/BTCPayServer/wwwroot/img/walletofsatoshi.svg?sanitize=true" alt="Wallet of Satoshi" height="100">
      <br>
      <span>Wallet of Satoshi</span>
    </a>
  </td>
  <td align="center" valign="middle">
    <a href="https://nomics.com/" target="_blank">
      <img src="https://raw.githubusercontent.com/btcpayserver/btcpayserver/master/BTCPayServer/wwwroot/img/nomics.svg?sanitize=true" alt="Nomics" height="100">
      <br>
      <span>Nomics</span>
    </a>
  </td>
  <td align="center" valign="middle">
    <a href="https://coincards.com/" target="_blank">
      <img src="https://raw.githubusercontent.com/btcpayserver/btcpayserver/master/BTCPayServer/wwwroot/img/coincards.svg?sanitize=true" alt="Coincards" height="100">
      <br>
      <span>Coincards</span>
    </a>
  </td>
</tr>
Kraken
Kraken
Square Crypto
Square Crypto
PNXBET
PNXBET
Baillie Gifford
Baillie Gifford
ACINQ
ACINQ

If you'd like to support the project, please visit the donation page.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.