# How to run FoundationDB on a Mac?

**URL:** <https://forums.foundationdb.org/t/how-to-run-foundationdb-on-a-mac/3563>\
**Category:** Using FoundationDB\
**Created:** [September 27, 2022, 8:23am UTC](https://forums.foundationdb.org/t/how-to-run-foundationdb-on-a-mac/3563 "2022-09-27T08:23:57Z")\
**Posts on this page:** 1\
**Showing post:** 30

<div class="post-metadata">

**Author:** ![carhops](https://avatars.discourse-cdn.com/v4/letter/c/a5b964/32.png) [@carhops](https://forums.foundationdb.org/u/carhops)\
**Post date:** [December 8, 2023, 10:07pm UTC](https://forums.foundationdb.org/t/how-to-run-foundationdb-on-a-mac/3563/30 "2023-12-08T22:07:42Z")

</div>

**Final update**

Things are working now, and I’m pretty sure I tracked down the problem:

> <https://github.com/apple/foundationdb/blob/3a04f8729d114b85226fd0c3cd61fec51ffc3455/fdbserver/Ratekeeper.actor.cpp#L843-L847>

Although I had free disk space, it wasn’t enough based on how `minFreeSpace` is calculated.

"First Aid” was a red herring; instead, I believe it freed up just enough disk space so that the operating space for “log server” cleared 0.0 GB.

This was further confirmed after I went on a deleting spree, trashing old iOS simulators, cache files, etc.; the “log server” operating space increased, and everything worked perfectly.

I also ran across [Work around "Storage server running out of space (approaching 5% limit)" on your developer machine - #3 by KrzysFR](https://forums.foundationdb.org/t/work-around-storage-server-running-out-of-space-approaching-5-limit-on-your-developer-machine/1814/3) which provides a work-around for running out of free space in a development environment.

My new config looks like:

```auto
% cat /usr/local/etc/foundationdb/foundationdb.conf 
## foundationdb.conf
##
## Configuration file for FoundationDB server processes
## Full documentation is available at
## https://apple.github.io/foundationdb/configuration.html#the-configuration-file

[general]
restart-delay = 60
## by default, restart-backoff = restart-delay-reset-interval = restart-delay
# initial-restart-delay = 0
# restart-backoff = 60
# restart-delay-reset-interval = 60
cluster-file = /usr/local/etc/foundationdb/fdb.cluster
# kill-on-configuration-change = true

## Default parameters for individual fdbserver processes
[fdbserver]
command = /usr/local/libexec/fdbserver
public-address = auto:$ID
listen-address = public
datadir = /usr/local/foundationdb/data/$ID
logdir = /usr/local/foundationdb/logs
# logsize = 10MiB
# maxlogssize = 100MiB
# machine-id =
# datacenter-id =
# class = 
# memory = 8GiB
# storage-memory = 1GiB
# cache-memory = 2GiB
# metrics-cluster =
# metrics-prefix =
knob_min_available_space_ratio=0.001 # <<<<< Add this line

## An individual fdbserver process with id 4689
## Parameters set here override defaults from the [fdbserver] section
[fdbserver.4689]

[backup_agent]
command = /usr/local/foundationdb/backup_agent/backup_agent
logdir = /usr/local/foundationdb/logs

[backup_agent.1]

```

This information seems like it might be useful to other developers; perhaps there’s a place for it in the wiki or “getting started” project documentation?

---

_[View the full topic](https://forums.foundationdb.org/t/how-to-run-foundationdb-on-a-mac/3563)._