Skip to content

bitcoinops/bitcoinops.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

287bf3b · Mar 24, 2025
Jun 7, 2023
Aug 2, 2024
Apr 27, 2024
Aug 26, 2024
Mar 22, 2025
Aug 19, 2024
May 23, 2023
Mar 24, 2025
Jul 9, 2018
Mar 21, 2025
Jan 22, 2024
May 9, 2022
Aug 2, 2022
Feb 17, 2025
Dec 10, 2019
Sep 24, 2024
Jun 6, 2022
Feb 7, 2025
Sep 1, 2023
Apr 8, 2019
Aug 22, 2024
Sep 24, 2021
Aug 6, 2018
Sep 14, 2019
Dec 19, 2023
Mar 5, 2019
Apr 27, 2024
Jan 17, 2025
Aug 27, 2021
Aug 27, 2021
Jul 27, 2018
Aug 2, 2024
Jan 17, 2025
Jan 30, 2025
Jun 28, 2024
Apr 27, 2024
Jan 17, 2025
Jun 20, 2018
Sep 25, 2020
Feb 17, 2025
Apr 27, 2024
Aug 27, 2021

Repository files navigation

bitcoinops.github.io

The Bitcoin Operations Technology Group (Optech) works to bring the best open source technologies and techniques to Bitcoin-using businesses in order to lower costs and improve customer experiences.

An initial focus for the group is working with its member organizations to reduce transaction sizes and minimize the effect of subsequent transaction fee increases.

Long-term goals include providing documentation and training materials, a weekly newsletter, original research, and facilitating improved relations between businesses and the open source community.

Optech does not exist to make a profit, and all materials and documentation produced are placed in the public domain. We are supported by our generous founding sponsors and contributions from member companies.

If you're an engineer or manager at a Bitcoin company or an open source contributor and you'd like to be a part of this, please contact us at info@bitcoinops.org.

Building The Site Locally

To build the site without docker, you need to go through a one-time installation procedure that takes 15 to 30 minutes. After that you can build the site an unlimited number of times with no extra work.

Docker

Ensure docker and docker-compose are installed. Run the command in the project directory.

docker-compose up --build

To restart (in the event of code change).

docker-compose down -v && docker-compose up --build
Install The Dependencies

Install RVM

Install RVM using either the easy instructions or the more secure instructions.

Read the instructions printed to your console during setup to enable the rvm command in your shell. After installation, you need to run the following command:

source ~/.rvm/scripts/rvm

Install Ruby

To install Ruby 2.6.4, simply run this command:

rvm install 2.6.4

Sometimes this will find a pre-compiled Ruby package for your Linux distribution, but sometimes it will need to compile Ruby from scratch (which takes about 15 minutes).

After Ruby 2.6.4 is installed, make it your default Ruby:

rvm alias create default ruby-2.6.4

And tell your system to use it:

rvm use default

(Note: you can use a different default Ruby, but if you ever change your default Ruby, you must re-run the gem install bundle command described below before you can build the site. If you ever receive a "eval: bundle: not found" error, you failed to re-run gem install bundle.)

Install Bundle

When you used RVM to install Ruby, it also installed the gem program. Use that program to install bundle:

gem install bundle

Install the Ruby dependencies

Change directory to the top-level of your local repository (replace bitcoinops.github.io with the full path to your local repository clone):

cd bitcoinops.github.io

And install the necessary dependencies using Bundle:

bundle install

Some of the dependencies can take a long time to install on some systems, so be patient.

Once Bundle completes successfully, you can preview or build the site.

Preview The Site

To preview the website in your local browser, make sure you're in the bitcoinops.github.io directory and run the following command:

make preview

This will build the site and then print a message like this:

Server address: http://0.0.0.0:4000
Server running... press ctrl-c to stop.

Visit the indicated URL in your browser to view the site.

Build The Site

To build the site exactly like we do for the deployment server, make sure you're in the bitcoinops.github.io directory and run:

make

The resulting HTML for the entire site will be placed in the _site directory and various tests will be run.

Contributing

If you would like to contribute to the Bitcoin Optech project, please review the contributing guidelines.